Xbasic

Array isnull Method

Syntax

dim result as L = <array>.isnull()

Returns

resultLogical: Returns .t. if the array is null, otherwise .f.

Description

Returns whether or not the array is null (has no values).

Discussion

The <array>.isnull() method determines whether or not an array is null. An array is null if it has no elements.

Example

dim pArr[0] as p
? pArr.isnull()
= .T.

? pArr
= <Has no sub-properties>

dim cArr[5] as C
? cArr.isnull()
= .F.

? cArr
= [1] = ""
[2] = ""
[3] = ""
[4] = ""
[5] = ""

dim nArr[10] as N = rand()

? nArr.size()
= 10

? nArr
= [1] = 0.3302001953125
[2] = 0.546417236328125
[3] = 0.227874755859375
[4] = 0.5472412109375
[5] = 0.77069091796875
[6] = 0.973236083984375
[7] = 0.267120361328125
[8] = 0.787322998046875
[9] = 0.28668212890625
[10] = 0.876007080078125

? nArr.isnull()
= .F.

nArr.setnull()

? nArr.isnull()
= .T.

? nArr
= <Has no sub-properties>

? nArr.size()
= 0

nArr[2] = 12
ERROR: Array index out-of-bounds